Edit控件的使用

单行编辑控件

功能功能

可进行单行文本的编辑

属性介绍

1. Background 背景样式
2. LeftMargin 左侧间隔
3. RightMargin 右侧间隔
4. Text 默认文本
5. FontSize 字体大小
6. FontColor 字体颜色
7. DisableFontColor 禁用字体颜色
8. FontFamily 字体
9. ShowTipText 在没有输入内容之前，控件上显示提示文本
10. TipText 提示文本内容
11. TipFontColor 提示文字颜色
12. IsPassword 是否是密码输入
13. Password 替换字符内容
14. NumberOnly 是否只能输入数值
15. NegativeNum 是否允许输入负值
16. NumberRange 数值输入范围
17. NumberCount 可以输入几位数，-1代表没有限制
18. DigitNumCount 可以输入小数的位数

控件事件介绍

1. UIG_EDIT_SETFOCUS

事件处理示例：

 BEGIN_UIG_MESSAGE_MAP(CDemoDlg)
    ON_UIG_EDIT_SETFOCUS(_edit, EditFocus)
 END_UIG_MESSAGE_MAP()
 ...
 void CDemoDlg::EditFocus(IUIGearsControl* control)
{
    if (control == _edit)
    {   
    }
}

2. UIG_EDIT_KILLFOCUS

事件处理示例：

 BEGIN_UIG_MESSAGE_MAP(CDemoDlg)
    ON_UIG_EDIT_KILLFOCUS(_edit, KillFocus)
 END_UIG_MESSAGE_MAP()
 ...
 void CDemoDlg::KillFocus(IUIGearsControl* control)
{
    if (control == _edit)
    {   
    }
}

3. ON_UIG_EDIT_TEXTCHNAGE

事件处理示例：

 BEGIN_UIG_MESSAGE_MAP(CDemoDlg)
    ON_UIG_EDIT_TEXTCHNAGE(_edit, TextChanged)
 END_UIG_MESSAGE_MAP()
 ...
 void CDemoDlg::TextChanged(IUIGearsControl* control)
{
    if (control == _edit)
    {   
    }
}

接口介绍

1. SetText

接口描述: 设置文本内容

参数值:

参数名	参数类型	参数含义
text	const tchar*	文本内容

返回值:

bool

示例:

_demoCtrl->SetText();

2. GetText

接口描述: 获取文本内容

参数值:

无

返回值:

const tchar*

示例:

_demoCtrl->GetText();

3. GetIsPassword

接口描述: 是否是密码显示

参数值:

无

返回值:

bool

示例:

_demoCtrl->GetIsPassword();

4. SetIsPassword

接口描述: 设置密码显示

参数值:

参数名	参数类型	参数含义
password	bool	密码显示

返回值:

void

示例:

_demoCtrl->SetIsPassword();

5. SetPasswordChar

接口描述: 设置密码显示的替代字符

参数值:

参数名	参数类型	参数含义
passchar	const tchar*	字符内容

返回值:

void

示例:

_demoCtrl->SetPasswordChar();

6. GetPasswordChar

接口描述: 获取密码显示的替代字符

参数值:

无

返回值:

const tchar*

示例:

_demoCtrl->GetPasswordChar();

7. GetIsNumberOnly

接口描述: 获取是否只能显示数值

参数值:

无

返回值:

bool

示例:

_demoCtrl->GetIsNumberOnly();

8. SetIsNumberOnly

接口描述: 设置是否只能输入数值

参数值:

参数名	参数类型	参数含义
numberOnly	bool	只能输入数值

返回值:

void

示例:

_demoCtrl->SetIsNumberOnly();

9. GetHasNegativeNum

接口描述: 获取是否允许输入负值

参数值:

无

返回值:

bool

示例:

_demoCtrl->GetHasNegativeNum();

10. SetHasNegativeNum

接口描述: 设置是否允许有负值

参数值:

参数名	参数类型	参数含义
negativeNum	bool	允许负值

返回值:

void

示例:

_demoCtrl->SetHasNegativeNum();

11. SetNumber

接口描述: 设置显示的数值

参数值:

参数名	参数类型	参数含义
number	int	数值内容

返回值:

void

示例:

_demoCtrl->SetNumber();

12. GetNumber

接口描述: 获取数值内容

参数值:

无

返回值:

int

示例:

_demoCtrl->GetNumber();

13. SetNumberCount

接口描述: 设置可输入数值的位数

参数值:

参数名	参数类型	参数含义
count	int	可输入的位数

返回值:

void

示例:

_demoCtrl->SetNumberCount();

14. GetNumberCount

接口描述: 获取可输入数值的位数

参数值:

无

返回值:

int

示例:

_demoCtrl->GetNumberCount();

15. SetDigitNumCount

接口描述: 设置小数的位数

参数值:

参数名	参数类型	参数含义
count	int	小数位数

返回值:

void

示例:

_demoCtrl->SetDigitNumCount();

16. GetDigitNumCount

接口描述: 获取小数的位数

参数值:

无

返回值:

int

示例:

_demoCtrl->GetDigitNumCount();

17. SetRange

接口描述: 设置数值的范围

参数值:

参数名	参数类型	参数含义
min	int	最小值
max	int	最大值

返回值:

void

示例:

_demoCtrl->SetRange();

18. GetRange

接口描述: 获取数值的范围

参数值:

参数名	参数类型	参数含义
min	int&	最小值
max	int&	最大值

返回值:

void

示例:

_demoCtrl->GetRange();

19. SetBackgroundStyle

接口描述: 设置背景样式

参数值:

参数名	参数类型	参数含义
state	UIState	状态
style	IUIGearsRectStyle*	样式指针

返回值:

bool

示例:

_demoCtrl->SetBackgroundStyle();

20. GetBackgroundStyle

接口描述: 获取背景样式

参数值:

参数名	参数类型	参数含义
state	UIState	状态

返回值:

IUIGearsRectStyle*

示例:

_demoCtrl->GetBackgroundStyle();

21. SetMargin

接口描述: 设置左右的间隔

参数值:

参数名	参数类型	参数含义
left	int	左侧间隔
right	int	右侧间隔

返回值:

void

示例:

_demoCtrl->SetMargin();

22. GetMargin

接口描述: 获取左右的间隔

参数值:

参数名	参数类型	参数含义
left	int&	左侧间隔
right	int&	右侧间隔

返回值:

void

示例:

_demoCtrl->GetMargin();

23. GetFontSize

接口描述: 获取字体大小

参数值:

无

返回值:

unsigned int

示例:

_demoCtrl->GetFontSize();

24. SetFontSize

接口描述: 设置字体大小

参数值:

参数名	参数类型	参数含义
size	unsigned int	字体大小

返回值:

void

示例:

_demoCtrl->SetFontSize();

25. SetFontSize

接口描述: 设置字体大小

参数值:

参数名	参数类型	参数含义
size	unsigned int	字体大小

返回值:

void

示例:

_demoCtrl->SetFontSize();

26. SetFontColor

接口描述: 设置字体颜色

参数值:

参数名	参数类型	参数含义
color	unsigned int	字体颜色

返回值:

void

示例:

_demoCtrl->SetFontColor();

27. GetDisableFontColor

接口描述: 获取禁用字体颜色

参数值:

无

返回值:

unsigned int

示例:

_demoCtrl->GetDisableFontColor();

28. SetDisableFontColor

接口描述: 设置禁用字体颜色

参数值:

参数名	参数类型	参数含义
color	unsigned int	字体颜色

返回值:

void

示例:

_demoCtrl->SetDisableFontColor();

29. SetTipFontColor

接口描述: 设置tip字体颜色

参数值:

参数名	参数类型	参数含义
color	unsigned int	字体颜色

返回值:

void

示例:

_demoCtrl->SetTipFontColor();

30. GetTipFontColor

接口描述: 获取tip字体颜色

参数值:

无

返回值:

unsigned int

示例:

_demoCtrl->GetTipFontColor();

31. SetTipText

接口描述: 设置tip文字内容

参数值:

参数名	参数类型	参数含义
text	const tchar*	提示文字内容

返回值:

viod

示例:

_demoCtrl->SetTipText();

32. GetTipText

接口描述: 获取tip文字内容

参数值:

无

返回值:

const tchar*

示例:

_demoCtrl->GetTipText();

33. SetShowTipText

接口描述: 设置是否显示tip文字

参数值:

参数名	参数类型	参数含义
show	bool	是否显示tip文字

返回值:

void

示例:

_demoCtrl->SetShowTipText();

34. GetShowTipText

接口描述: 获取是否显示tip文字

参数值:

无

返回值:

bool

示例:

_demoCtrl->GetShowTipText();

35. SetFontFamily

接口描述: 设置字体

参数值:

参数名	参数类型	参数含义
family	const tchar*	字体

返回值:

void

示例:

_demoCtrl->SetFontFamily();

36. GetFontFamily

接口描述: 获取字体

参数值:

无

返回值:

const tchar*

示例:

_demoCtrl->GetFontFamily();

37. SetLeftMargin

接口描述: 设置左侧间隔

参数值:

参数名	参数类型	参数含义
margin	int	间隔大小

返回值:

void

示例:

_demoCtrl->SetLeftMargin();

38. GetLeftMargin

接口描述: 获取左侧间隔

参数值:

无

返回值:

int

示例:

_demoCtrl->GetLeftMargin();

39. SetRightMargin

接口描述: 设置右侧间隔

参数值:

参数名	参数类型	参数含义
margin	int	间隔大小

返回值:

void

示例:

_demoCtrl->SetRightMargin();

40. GetRightMargin

接口描述: 获取右侧间隔

参数值:

无

返回值:

int

示例:

_demoCtrl->GetRightMargin();

41. SetUseShortcut

接口描述: 设置是否使用快捷键模式

参数值:

参数名	参数类型	参数含义
shortcut	bool	快捷键

返回值:

void

示例:

_demoCtrl->SetUseShortcut();

42. GetUseShortcut

接口描述: 查询是否使用快捷键模式

参数值:

无

返回值:

bool

示例:

_demoCtrl->GetUseShortcut();

43. SetReadonly

接口描述: 设置只读模式

参数值:

参数名	参数类型	参数含义
readonly	bool	只读模式

返回值:

void

示例:

_demoCtrl->SetReadonly();

44. GetReadonly

接口描述: 是否为只读模式

参数值:

无

返回值:

bool

示例:

_demoCtrl->GetReadonly();